Function            strwcmp - compares a wild-carded string to
                                  another string

  Syntax              int strwcmp(char *wstr, char *str);

  Prototype in        stringhk.h

  Remarks             strwcmp performs an unsigned comparison of wstr and
                      str, starting with the first character in each
                      string and continuing with subsequent characters
                      until the corresponding characters differ or until
                      the end of the strings is reached. Wildcards (*,?)
                      are supported, as per DOS (* wildcards 0 or more
                      characters, ? wildcards a single character).

  Return value        strwcmp returns an int value that is

                           < 0       if wstr is less than str
                           = 0       if wstr is the same as str
                           > 0       if wstr is greater than str

                      Furthermore, if a comparison falls through during a
                      wildcard matching, -2 or 2 is returned. If a
                      mismatch is found without using wildcards, a -1 or
                      1 is returned.

  See also            strwicmp()